Displaying Windows

DISCUSSION

The DrawGrowIcon function draws a window's size box or, if the window can't be resized, whatever other image is appropriate to the window's type and active/inactive state. When you adopt the Appearance Manager directly, you never need to call the DrawGrowIcon function to get a size box in your window. Although you can still use DrawGrowIcon to draw the delimiting scroll bar lines, if you wish.

If you are going through the mapping layer, however, you do need to call DrawGrowIcon , but only once. This is because, with the Appearance Manager, once DrawGrowIcon is called, the size box is merged from the content region of the window into the window's frame.

Note that the DrawGrowIcon function doesn't erase the scroll bar areas. If you use DrawGrowIcon to draw the size box and scroll bar outline, therefore, you should erase those areas yourself when the window size changes, even if the window doesn't contain scroll bars.

For inactive document windows, DrawGrowIcon draws the lines delimiting the size box and scroll bar areas and erases the size box. For active document windows, DrawGrowIcon draws the grow image in the size box in the lower-right corner of the window's graphics port rectangle, along with the lines delimiting the size box and scroll bar areas. To draw the size box but not the scroll bar outline, set the clipRgn field in the window's graphics port to be a 15-by-15 pixel rectangle in the lower-right corner of the window.

VERSION NOTES

Usage changed with Appearance Manager 1.0; you need call DrawGrowIcon only when not adopting the Appearance Manager directly.